home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / Languages / Python 1.1 / Extensions / README < prev   
Encoding:
Text File  |  1994-09-14  |  2.0 KB  |  45 lines  |  [TEXT/R*ch]
  1. Python 1.1 Extensions
  2. =======================
  3.  
  4. This directory contains extension modules to Python.  You must already
  5. have built and installed Python 1.1 (or possibly higher).  This
  6. 'Extensions' directory should be a direct subdirectory of Python's
  7. toplevel directory (where the configure script lives).
  8.  
  9. Here's a list of available extensions; note that several are
  10. unsupported or unfinished.  (Authors listed are for the extensions,
  11. not for the software they interface to -- when not listed, I wrote it
  12. myself.)  Each extension has its own README file:
  13.  
  14. X11         Guess what?  (Works but still somewhat rough)
  15. af        DEC CRL's AudioFile (probably incomplete)
  16. amoeba        Free University's Amoeba distributed operating system
  17. gsm        "GSM" audio encoding
  18. jpeg        JPEG image compression, by Jack Jansen
  19. metalbase    Metalbase database, by Lance Ellinghouse
  20. mSQL        MiniSQL database, by Anthony Baxter
  21. ptx        Pseudo TTYs, by Jaap Vermeulen (Sequent specific)
  22. socks        SOCKS (socket interface through filewall), by Dan Connolly
  23. suit        U of V's Simple UI Toolkit, by Bill Carlson & Matt Conway
  24. wafe        WAFE (Tcl with X widgets), by Gustaf Neumann
  25.  
  26. Althoug theoretically each extension can have its own Makefile.pre.in,
  27. in practice they all share exactly the same Makefile.pre.in file --
  28. all dependencies on the module being built are in the Setup(.in) file.
  29. For convenience, and in order to avoid having to update N copies each
  30. time I add a feature to the generic Makefile.pre.in file, the
  31. extension directories all contain a symbolic link to
  32. ../Makefile.pre.in.
  33.  
  34. Each extension does have its own Setup.in file, which is used in the
  35. same manner as Modules/Setup.in in the main Python distribution (so
  36. you never edit Setup.in -- you copy it to Setup and edit that).  The
  37. configuration and build process is explained in detail in comments in
  38. Makefile.pre.in.
  39.  
  40. There are also some examples that help you create your own extensions:
  41.  
  42. example        A simple example -- adds module 'xx'
  43. example2    Adds module 'yy' to the previous example (i.e. adds 'xx', 'yy')
  44. example3    Adds module 'zz' to example2 (i.e. adds 'xx', 'yy', and 'zz')
  45.